Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 3 - Window Manager Reference / Window Manager Functions

Retrieving Window Information /

GetWindowRegion

NEW WITH THE APPEARANCE MANAGER

Gets a handle to a specific window region.

pascal OSStatus GetWindowRegion (
                     WindowPtr inWindow,
                     WindowRegionCode inRegionCode,
                     RgnHandle ioWinRgn);

inWindow

On input, a pointer to the window whose region you wish to receive a handle to.

inRegionCode

Pass a constant representing the window region whose handle you wish to obtain; see "Window Region Constants".

ioWinRgn

On input, a handle to a region created by your application. On output, a handle to the specified window region.

function result

A result code; see "Result Codes".

DISCUSSION

The GetWindowRegion function produces a handle to a window definition function's window region in response to a kWindowMsgGetRegion message. The visibility of the window is unimportant for GetWindowRegion to work correctly.

SEE ALSO

"Appearance Manager Gestalt Selector Constants".